---
title: Webex
---

**WebexTools** enable an Agent to interact with Cisco Webex, allowing it to send messages and list rooms.

## Prerequisites

The following example requires the `webexpythonsdk` library and a Webex access token which can be obtained from [Webex Developer Portal](https://developer.webex.com/docs/bots).

To get started with Webex:

1. **Create a Webex Bot:**
   - Go to the [Developer Portal](https://developer.webex.com/)
   - Navigate to My Webex Apps → Create a Bot
   - Fill in the bot details and click Add Bot

2. **Get your access token:**
   - Copy the token shown after bot creation
   - Or regenerate via My Webex Apps → Edit Bot
   - Set as WEBEX_ACCESS_TOKEN environment variable

3. **Add the bot to Webex:**
   - Launch Webex and add the bot to a space
   - Use the bot's email (e.g. test@webex.bot)

```shell
pip install webexpythonsdk
```

```shell
export WEBEX_ACCESS_TOKEN=your_access_token_here
```
## Example

The following agent will list all spaces and send a message using Webex:

```python cookbook/tools/webex_tool.py
from agno.agent import Agent
from agno.tools.webex import WebexTools

agent = Agent(tools=[WebexTools()])

# List all spaces in Webex
agent.print_response("List all space on our Webex", markdown=True)

# Send a message to a Space in Webex
agent.print_response(
    "Send a funny ice-breaking message to the webex Welcome space", markdown=True
)
```

## Toolkit Params

| Parameter      | Type   | Default | Description                                                                                |
| -------------- | ------ | ------- | ------------------------------------------------------------------------------------------ |
| `access_token` | `str`  | `None`  | Webex access token for authentication. If not provided, uses WEBEX_ACCESS_TOKEN environment variable. |
| `enable_send_message` | `bool` | `True`  | Enable sending messages to Webex spaces.                                                   |
| `enable_list_rooms`   | `bool` | `True`  | Enable listing Webex spaces/rooms.                                                         |
| `all`   | `bool` | `False`  | Enable all functionality.                                                         |

## Toolkit Functions

| Function       | Description                                                                                                |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| `send_message` | Sends a message to a Webex room. Parameters: `room_id` (str) for the target room, `text` (str) for the message. |
| `list_rooms`   | Lists all available Webex rooms/spaces with their details including ID, title, type, and visibility settings.   |


## Developer Resources

- View [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/webex.py)
- View [Cookbook](https://github.com/agno-agi/agno/tree/main/cookbook/tools/webex_tools.py) 